home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 18 / CU Amiga Magazine's Super CD-ROM 18 (1997)(EMAP Images)(GB)[!][issue 1998-01].iso / CUCD / Online / hsc / docs-source / about.hsc next >
Encoding:
Text File  |  1997-06-04  |  4.3 KB  |  102 lines
  1. <WEBPAGE chapter="hsc - " title="Introduction"
  2.     PREV="index.html"
  3.     NEXT="copy.html"
  4.     QTEXT="Welcome Boyz and Girls to the Non-Official Shit-Reduction Program"
  5.     QAUTHOR='Novi Sad, "Me, Myself, All Over Again"'>
  6.  
  7. The main purpose of this chapter is to help you deciding whether you
  8. should go on reading this documentation or not.
  9.  
  10. <H2>Motivation</H2>
  11.  
  12. <P>If you read this, it's quite likely that you tried to design a html
  13. page. And you probably found out that html is a very clumsy thing: No
  14. macros, no include files and several other features lacking.</P>
  15.  
  16. <P>And what can you do after your page is ready? View it with a
  17. browser and test-click all links? Pfuahahaha! Most browser are
  18. designed to handle as many errors as possible and display a readable
  19. page, but don't mention your errors! And link-testing is a very stupid
  20. task...</P>
  21.  
  22. <P>Of course, there are several tools around: You can use a macro
  23. languages like <EXEC>m4</EXEC> to define macros and include files, use
  24. some of the various html validators, replace your special characters
  25. with <KBD>recode</KBD> and run a link validation tool on your
  26. page.</P>
  27.  
  28. <P>So, after installing several Tools (and compilers and
  29. interpreters), you are ready to go... and can start five programs
  30. after a simple change to one of your pages.</P>
  31.  
  32. <*
  33. <P>(Note: People who use the C-Preprocessor are easy to identify 
  34. by the silly date format of <CODE>__DATE__</CODE>: who writes
  35. <CODE>Feb 23 1995</CODE> on purpose?)</P>
  36. *>
  37.  
  38. <H2>What It Is</H2>
  39.  
  40. <P><hsc CAP> tries to summarize the functionality of all
  41. these tools in one program: it performs a (basic) syntax
  42. check, validates your (local) links, replaces special characters
  43. by entities and provides a way to define macros which should
  44. remind you to html.</P>
  45.  
  46. <P>It also supports several features you probably will not find in
  47. most other tools, like <A HREF="features/uris.html#prjrel">project
  48. relative URIs</A>, stripping useless white spaces and automatically
  49. setting the <A HREF="features/getsize.html">attributes for images
  50. size</A>.</P>
  51.  
  52. <P>Furthermore it provides some concepts to maintain your project with
  53. popular tools like <make>.</P>
  54.  
  55. <H2>How It Works</H2>
  56.  
  57. <P><hsc CAP> simply acts as a preprocessor: You give it an "extended"
  58. html-source (later in this document referred as "hsc source")
  59. containing special commands, and <hsc> interprets it and produces a
  60. pure html output as object file. This output file can be viewed with
  61. your w3-browser.</P>
  62.  
  63. <P>Normally you will create your hsc sources using a simple text
  64. editor, maintain them in a <Makefile> and process them with <hsc>. At
  65. least I consider this the recommend way of using this tool.</P>
  66.  
  67. <H2>What It Is Not</H2>
  68.  
  69. <P>Obviously, there is no fancy GUI, no (pseudo-)WYSIWYG, no drag
  70. & drop - there are other programs which provide these
  71. functionalities. But a common lack of these programs usually is that
  72. they give less support for large projects and are limited in
  73. configurability.</P>
  74.  
  75. <P>If you just want to create your own personal homepage, write a
  76. short html document with information about your three selfwritten
  77. freeware-proggies, include a picture of your cat, send greets to Sepp
  78. and Hugo or something like that, there are probably other tools which
  79. are easier to handle and will serve your needs more or less well.</P>
  80.  
  81. <P>It should also be stated that you will require several experiences
  82. usually not needed for w3-authoring (or better: not expected to be
  83. needed by most people). This includes a basic understanding of macro
  84. creation, writing <Makefile>s and playing around with scripting
  85. languages like Rexx. If you have never done such things before, I
  86. recommend you forget this package soon and come back in a few
  87. years.</P>
  88.  
  89. <P>This also is no install-and-run package. You will need several
  90. other tools to fully use it, and it is not within the scope of this
  91. documentation which one you choose. Although it contains some comments
  92. and suggestions about that at various places.</P>
  93.  
  94. <P>Despite the the html- and w3-hype of the recent years, both this
  95. tool and the author of it consider many concepts introduced with it
  96. ridiculous, braindead and sometimes even pure shit. So this manual
  97. contains opinions and language you might consider offensive. If you
  98. want to hear the usual "Oh how great are all those things!", you will
  99. have to look for something else.</P>
  100.  
  101. </WEBPAGE>
  102.